﻿<!DOCTYPE HTML>
<html lang="en">
<head>
<title>ProcessGetName / ProcessGetPath - Syntax &amp; Usage | AutoHotkey v2</title>
<meta name="description" content="The ProcessGetName and ProcessGetPath functions return the name or path of the specified process." />
<meta name="ahk:equiv-v1" content="index.htm" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>ProcessGetName / ProcessGetPath</h1>

<p>返回指定进程的名称或路径.</p>

<pre class="Syntax">Name := <span class="func">ProcessGetName</span>(<span class="optional">PIDOrName</span>)
Path := <span class="func">ProcessGetPath</span>(<span class="optional">PIDOrName</span>)</pre>

<h2 id="Parameters">参数</h2>
<dl>
    <dt>PIDOrName</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#numbers">整数</a>或<a href="../Concepts.htm#strings">字符串</a></p>
        <p>如果省略, 则使用脚本本身的进程. 否则, 指定一个数字(PID) 或进程名:</p>
        <p><strong>PID:</strong> 进程 ID, 这是一个唯一标识一个特定进程的数字(这个数字仅在该进程的生命周期内有效). 新启动进程的 PID 可以通过 <a href="Run.htm">Run</a> 函数确定. 同样, 窗口的 PID 也可以通过 <a href="WinGetPID.htm">WinGetPID</a> 来确定. <a href="ProcessExist.htm">ProcessExist</a> 也可以用来获取 PID.</p>
        <p><strong>Name:</strong> 进程名通常与它的可执行文件(没有路径) 相同, 例如 notepad.exe 或 winword.exe. 因为一个名称可能与多个正在运行的进程匹配, 所以只对第一个进程进行操作. 名称不区分大小写.</p>
    </dd>
</dl>

<h2 id="Return_Value">返回值</h2>
<p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
<p>ProcessGetName 返回指定进程的名称. 例如: notepad.exe.</p>
<p>ProcessGetPath 返回指定进程的路径. 例如: C:\Windows\notepad.exe.</p>

<h2 id="Error_Handling">错误处理</h2>
<p>如果找不到进程, 则抛出 <a href="Error.htm#TargetError">TargetError</a>.</p>
<p>如果无法检索名称/路径, 则抛出 <a href="Error.htm">OSError</a>.</p>

<h2 id="Related">相关</h2>
<p><a href="Process.htm">进程函数</a>, <a href="Run.htm">Run</a>, <a href="WinGetProcessName.htm">WinGetProcessName</a>, <a href="WinGetProcessPath.htm">WinGetProcessPath</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 获取用于打开文档的进程的名称和路径.</p>
<pre>Run "license.rtf",,, &amp;pid  <em>; 这可能存在于 C:\Windows\System32.</em>
try {
    name := ProcessGetName(pid)
    path := ProcessGetPath(pid)
}
MsgBox "Name: " (name ?? "could not be retrieved") "`n"
    .  "Path: " (path ?? "could not be retrieved")
</pre>
</div>

</body>
</html>